home *** CD-ROM | disk | FTP | other *** search
/ Aminet 52 / Aminet 52 (2002)(GTI - Schatztruhe)[!][Dec 2002].iso / Aminet / mus / play / DelfMPEG.lha / DelfMPEG / arexx.txt next >
Text File  |  2002-10-30  |  3KB  |  94 lines
  1. DelfMPEG 0.6 ARexx doc
  2. (Thu 27-Jul-2000)
  3.  
  4.  
  5. DelfMPEG can operate in two different modes:
  6. -interactive mode
  7.   (play files that were specified by the FILES command line option or
  8.   selected using the reqtools requester)
  9. -ARexx mode
  10.   (activated by the AREXX command line option; the program is controlled
  11.   via the ARexx commands listed below)
  12.  
  13.  
  14. To get DelfMPEG into ARexx mode just specify the AREXX command line option,
  15. together with the other options you want to use.
  16. Only one instance of DelfMPEG can run in ARexx mode at the same time.
  17.  
  18. examples:
  19. DelfMPEG AREXX VERBOSE SHOWTAG
  20.   (gives you a lot of output, including all received ARexx commands)
  21.  
  22. DelfMPEG >NIL: AREXX SHOWTAG
  23.   (no output at all)
  24.  
  25.  
  26.  
  27. ARexx commands  -  port name 'DELFMPEG'
  28.  
  29.  
  30.  
  31. QUIT
  32.     quit program
  33.  
  34. PLAY <filename>
  35.     play the specified file; this command only works if the player had been
  36.     stopped before, during playback the PLAY command is simply ignored
  37.  
  38. STOP
  39.     stop playback; it's usually a good idea to use STOP before PLAY
  40.  
  41. PAUSE
  42.     pause playback; can also be used before PLAY command (when the player is
  43.     stopped), the next PLAY will initialize the file reader without starting
  44.     playback, you can use the GET... commands to get some file info and later
  45.     use CONTINUE to start playback
  46.  
  47. CONTINUE
  48.     continue playback after PAUSE command
  49.  
  50. SETVOLUME <number>
  51.     set playback volume (in per cent; range 0...200)
  52.     this command always works, even before PLAY; please note that values
  53.     higher than 100 might cause distortions due to output clipping (you'd
  54.     better use the controls of your amplifier to boost the volume)
  55.  
  56. SETPOSITION <seconds>
  57.     set playback position inside the file that's currently playing; this
  58.     command works in PLAY and PAUSE mode, but not in STOP mode
  59.     **NOTE: this doesn't work if the STRICT command line option is specified!
  60.  
  61. GETSTATUS
  62.     get program status code:
  63.     0  - player stopped (after STOP command or when playback is finished)
  64.     1  - playing (after PLAY and/or CONTINUE command)
  65.     2  - player paused (after PAUSE command)
  66.     10 - error: initDelfina failed
  67.     20 - error: file not found
  68.     30 - error: file not recognized as MPEG1 audio
  69.     (if an error occurs then the player automatically returns to STOP mode)
  70.  
  71. GETFILENAME
  72.     get file name (was set by a PLAY command before)
  73.  
  74. GETFILETYPE
  75.     get file type information (MPEG layer, bit rate, sampling rate, channels);
  76.     this is the same string that DelfMPEG also prints to stdout
  77.  
  78. GETDURATION
  79.     get total playback duration of the file (in seconds)
  80.  
  81. GETPOSITION
  82.     get current playback position in the file (in seconds)
  83.     **NOTE: this doesn't work if the NOTIMER command line option is specified!
  84.  
  85. GETTITLE
  86. GETARTIST
  87. GETALBUM
  88. GETCOMMENT
  89. GETYEAR
  90. GETGENRE
  91.     get ID3v1 tag information; the returned strings will be empty if the info
  92.     is not available; GETGENRE returns the genre number (e.g. 17 for 'Rock')
  93.     **NOTE: you need to specify the SHOWTAG command line option for this!
  94.